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ABSTRACT 


EDITOR I is an on-line program within the initial PHOENIX 
computer software system which enables the system user to create, 
destroy, or modify his collection of symbolic data, organized as 
files. 

The actions of EDITOR I are user-controlled by means of a one- 
pass assembler, herein described. 
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GLOSSARY OF TERMS 


actor 

argument 

argument separator 

atom 

binary connector 

block 

cln 

closed file 

command 

command separator 

config 

constant 

directory 


a symbol which has a computed numeric value 
which is some line number of the open file. 

an atom or group of atoms used as control 
parameters by EDITOR commands. 

a type of symbol which must appear between 
arguments--the EDITOR initially defines the 
character ,, , M (comma) as such. 

the lowest logical and informational group 
processed by the control language. 

a type of symbol used to concatenate expression 
elements--the EDITOR initially defines the 
characters ,, + M and n - M as such. 

a group of one or more lines which have con¬ 
tiguous line numbers. 

an actor whose value is the current line number 
in the open file. 

one of two file states, in which a file can 
only be read. 

a user request for a specific action to be 
performed by the EDITOR. 

a type of symbol which must end the argument 
string of a command, including the null argu¬ 
ment string--the EDITOR initially defines the 
character 11 ; n (semi-colon) as such. 

an actor whose value is the line number in 
which a specified literal argument is located. 

a type of symbol which has a numeric value. 

a list of file names of all existing files. 
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exp ression 

a type of argument consisting of one or more 
expression elements connected by binary 
connectors. 

expression element 

a numeric atom or a constant or an actor. 

file 

a block of lines accessed through a file name. 

file name 

a type of symbol which must be an atom of type 
variable, and is an unique reference to a file. 

file state 

the two states in which a file can exist, 
either open or closed. 

file structure 

a general term meaning the entire character 
string being handled by the EDITOR. 

flag 

an actor whose value is the line number of an 
uniquely specified line, wherever it appears in 
the open file. 

independent atom 

a type of atom which is a self-delimiting atom', 
an atom which stands by itself and acts as a 
delimiter for other types of atoms--all 
characters of type punctuation are such. 

1 ine 

a string of characters in a file, the last 
character, and only the last, of which must be 
a carriage return. 

line number 

the numeric quantity associated with each line; 
the first line in a file is line 0 (zero). 

literal argument 

a type of argument which is a literal atom. 

literal atom 

a contiguous string of any characters, except 
carriage return, end of message, start of 
message, erase, and partial message, bounded 
by a closed, balanced pair of left and right 
quotes. 

lln 

an actor whose value is the line number of the 
last line in the open file. 
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new 

a type of argument which is an undefined symbol. 

numeric atom 

a type of atom consisting of a contiguous string 
of numeric characters. 

open file 

one of two file states, in which a file can be 
modified--or that file (only one file may be 
open at any given time) which is in that state. 

op erator 

a type of symbol which is a request for a 
specific action by the EDITOR. 

symbol 

an atom of type variable or type independent 
which appears in the symbol table, either 
initially or as a result of the user's commands, 
and carries with it an associated type and value 

symbol argument 

a type of argument which is any symbol which 
appears in the symbol table, and which is not 
of type undefined. 

symbol table 

a segment of the EDITOR which stores the type, 
value, and character representation of all 
symbols used by the EDITOR in the translation of 
the control language. 

symbol type 

the logical category in which the symbol belongs 
or is classified; the EDITOR recognizes eight 
types of symbols. 

symbol value 

the value of a symbol depends upon the type of 
the symbol and may be either a subroutine call 
to perform an action upon the user's file, or a 
subroutine call to perform an action upon the 
symbol table itself, or a number used during the 
execution of an EDITOR action, or a subroutine 
call to compute a number, or a pointer to a file 
location. 

undefined symbol 

either a symbol which does not appear in the 
symbol table, or a symbol which appears in the 
symbol table as being of type undefined--such 
a symbol has no value associated with it. 
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variable atom 


a type of atom consisting of a contiguous 
string of numeric or alphabetic characters, 
at least one of which is of type alphabetic. 




SECTION I 


INTRODUCTION 

EDITOR I is an on-line program within the PHOENIX computer soft¬ 
ware system which gives the system user complete file manipulation 
capabilities upon symbolic data, by the issuance of commands through 
a PHOENIX typewriter. 

This report serves as a user's guide or manual to EDITOR I, 
and is generally concerned with those features which remain invariant, 
no matter under what monitor system EDITOR I is operating. 

The user's data will be referenced by the program as a character 
string delineated and ordered into lines by carriage returns. Such a 
collection of lines is called a file and is referenced by a symbolic 
file name. 

The actions of the EDITOR are user-controlled by means of a one- 
pass assembler, described in sections IV and V of this report. 
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SECTION II 


BRIEF DESCRIPTION 


2.1 Properties 

EDITOR I is an on-line, user-control led, file manipulator pro¬ 
gram, providing symbol definition capability and complete editing 
functions. 

2.2 Limitations 

The present machine-implemented version of the EDITOR subjects 
the user's data to the following restrictions: 

a) a single file may contain no more than 4,0946 lines; 

b) the symbol table will accommodate approximately 200 
user-defined, variable-length, symbol entries; 

c) the number of separate files allowed, at any one time, 
depends upon the room for entries in the symbol table; and 

d) all the files together, existing in the system at any one 
time, may contain no more than 184,320 characters. 

2.3 Current Status 

The EDITOR is operational. 

2.4 Operation 

The EDITOR will perform manipulative functions upon data and data 
printouts, as requested by the user, in sequence and through commands 
typed on a PHOENIX typewriter attached to the PHOENIX computer, subject 


to legality checks. 
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SECTION III 


DATA STRUCTURE 


3.1 Lines and Line Numbers 

A 1ine is a string of characters, the last, and only the last, 
character of which must be a carriage return. 

Each line has associated with it a numeric quantity called the 
1ine number . The line number is the user's primary means of accessing 
a line within a given file. The line number of a given line may be 
computed at any time by counting the number of lines between the given 
line and the start of the file. The first line in a file is line 0 
(zero). 

If line 'n' is deleted from a file, the line numbers of all lines 
from 'n' through the last line are decreased by 1. If a line is in¬ 
serted into a file at line number 'n', all line numbers from 'n' through 
the last line number are increased by 1. 

3.2 Blocks 

A block is a group of one or more lines which have contiguous 
line numbers. A block is specified by the line numbers of the first 
and last lines in the block, in that order. 

3.3 Files 

A file is a block or blocks of lines which the user may access 
through a file name (see 3.3.2). A single file may contain no more 


than 4,096 lines. 
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3.3.1 File Structure 


The file structure is a general term meaning the entire 
character string being handled by the EDITOR, and may comprise both 
accessible files and blocks of lines which are no longer accessible, 
due to the user's commands. The entire file structure, at any one 
time, may contain no more than 184,320 characters. (Facilities for 
garbage collection upon the file structure are available in the 
command repertoire.) Inaccessible lines in the file structure are 
caused by destroyed files and the rewriting of altered files. 


3.3.2 File Names 

A file name is an unique alphanumeric character sequence 
by which a file is accessed by the system user. The user may change 
the name of any file or combine the contents of several files in a 
straightforward manner by means of the command repertoire. 


3.3.3 File States 

A file can only be in one of two states, open or closed . 

A file may be modified only when it is in the open state, and only 
one file may be open at any given time. 

3.4 Syntactical Chart 

Meta-1inguistica1ly, we restate the above definitions of the data 
structure as follows (in Backus normal form*): 


*See Appendix V for a description of Backus normal form. 
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< ^ >::= carriage return 

<character>::= any typewriter character, red or black, 
upper or lower case, except < ^ > 
<line>::= <character> < ^ >|<character> <line> 
<block>::= <line>|<block> <line> 

<file>::= <block>|<file> <block> 
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SECTION IV 


THE CONTROL LANGUAGE 

This section contains a description of the syntax or rules of 
formation of the control language through which the user issues 
commands to the EDITOR. A word of caution is in order at this point-- 
in no way should the syntax of the data structure or user's files, as 
described in Section III, be confused with the syntax of the control 
language through which the EDITOR is commanded. 

As characters are typed and placed into the input buffer, the 
EDITOR segments the characters according to their properties and 
groups them into larger and larger logical units, called atoms, 
symbols, arguments, actors, and commands. These logical units or 
subdivisions of the control language are analogous to the parts of 
speech of natural language. 

Basically, there are four types of atoms which can form eight 
types of symbols which, in turn, give rise to the various arguments, 
actors, and commands. 

Associated with a symbol are the two characteristics, "type" and 
"value." The type and value of a symbol should not be confused with 
each other. The type of a symbol is the logical category in which it 
belongs or is classified (much as a word is either a noun or adverb 
or another one of the parts of speech), while the value of a symbol is 
the meaning associated with it, or bound to it, by convention or decree. 
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For example, the word "quarter" denotes a certain type of coin 
which has a value of twenty-five cents, while the word "two bits" de¬ 
notes any number of coins whose total value is twenty-five cents. 


In much the same way, the character string "three" in the EDITOR 
can be defined by the user to be a symbol of type constant with the 
value of 3, while the character string "constant" is defined by the 
EDITOR to be a symbol of type constant with the value of 3. 

4.1 C haracter Set 

The character set of the input string to the control language is 
that of the MITRE ball 2 for the PHOENIX typewriter. 


The following notation symbolizes the non-printing function 
keys of the PHOENIX typewriter (in Backus normal form): 


< *> 

< ) > 

< h* > 

< T > 
<3 > 

< E > 

<q > 

< □ > 

<a > 


: = carriage return 
:= erase 
:= tabulate 
:= index 

:= end of message 
:= start of message 
:= partial message 
:= space 
:= backspace 
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The following characters are recognized by the EDITOR by class: 


Class 

numeric 

punctuation 

spacing 

carriage return 
start of message 
partial message 
erase 
undefined 
alphabetic 


Member 

0123456789 

+-*(),;$' ' 

□ H 

> 

s 

q 

Q 3 and all illegal codes 
all others 


4.2 Character Source Mechanism 

The character source mechanism of the EDITOR processes the input 
character string into commands (according to rules of formation to 
be described) and the EDITOR executes these commands in sequence as 
they appear. However, the typewriter will remain in input status 
until a carriage return is struck, and more than one command may be 
typed across the page, properly separated by command separators, of 
course. No processing of the commands will occur until the user types 
a carriage return. If there is no typeout from the typewriter to 
indicate that a command has been performed, a carriage return will be 
performed. If an illegal command or an incorrectly formed command 
appears, appropriate error messages will be typed out, and the 
character source mechanism will go to the next command, or, if there 
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is none, return the typewriter to input status awaiting a new input 
from the user. Meaningless alphabetic input character strings cause a 
"?" to be typed out. 

The character source mechanism will trap all carriage returns, 
removing them from the input string, and then return the typewriter 
to the user for a new input. This has been done to allow the user 
flexibility in formatting in certain commands. In the case where a 
literal character string is to be processed as a line image (for 
adding to or inserting into a file, for example), the character source 
mechanism will insert the carriage return, at the end of the line 
image, for the user. 

The detection of an undefined character in the input string will 
cause an error message to be typed out. 

During the operation of the EDITOR, any striking of the start of 
message key during typeout will cause the EDITOR to '’shut up” and 
return to the character source mechanism. 

When the user is typing inputs, hitting the partial message key 
will remove the last character typed into the input buffer and echo 
it back in red; if all characters are removed, subsequent depressing of 
the partial message key will cause a carriage return to be performed. 
Hitting the erase key removes the entire line from the input buffer 
and also causes a carriage return to be performed. 
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4.3 Typewriter Dialect 


At present, the "typewriter dialect" expected by the EDITOR in 
its dialogue with the user is "lower case black" except where user 
definitions and syntax override it. These exceptions are duly described. 

The EDITOR responds in "lower case red" except when typing out 
files, symbols, and so forth, where the character color is considered 
to be part of the "name" or line "image," in which case the actual 
color of the character is typed out. 

4.4 Segmentation 

The characters of the input string are segmented into units, 
called atoms , according to the rules described below. Atoms are the 
lowest logical and informational groups processed by the control 
language. 

4.5 Atom Types and Rules of Formation 

4.5.1 Variable Atoms 

A variable atom is a contiguous string of characters of 
type numeric or alphabetic, at least one of which is of type alphabetic. 

A variable atom is delimited by a character of type punctuation or 
type spacing. 

4.5.2 Numeric Atoms 

A numeric atom is a contiguous string of characters of 
type numeric, delimited by a character of type punctuation or type 
spacing. 
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4.5.3 Independent Atoms 


All characters of type punctuation are independent atoms . 
An independent atom is a self-delimiting atom, an atom which stands by 
itself and which also acts as a delimiter for other types of atoms. 

4.5.4 Literal Atoms 

A 1iteral atom is a contiguous string of any characters, 
except carriage return, end of message, start of message, erase, and 
partial message, bounded by a closed, balanced pair of left and right 
quotes (' and ' ), the left quote being to the left of the literal, the 
right quote being to the right of the literal. All characters between 
the quotes, including spaces and quotes, are part of the literal. The 
EDITOR keeps count of left and right quotes and will consider the 
literal ended when the number of right quotes equals that of the left 
quotes. 

Note that a literal atom follows the syntax of the data structure 
(see Section 3.4) as far as character case and color are concerned. 

(A future implementation of the EDITOR will change the rules of 
formation for literal atoms but at present the above is the one that 
is operational.) 

4.6 Syntactical Chart 

Meta-1inguistically, we restate the above definitions for atom 
formation as follows: 
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<n-char>::= 011J 2131A|5)617|819 
<p-char>::= +|-|*|(|)!,|;|$|' V 
<s-char>::= □|h 

< ^>::= carriage return 

< £>:: = start of message 

< ^ >::= partial message 

< 3 >::= erase 

<u-char>: : = £) 15 | and any illegal code 
<a-char>::= all others 
<i-atom>::= <p-char> 

<n-atom>::= <n-char>|<n-char> <n-atom> 

<v-atom>::= <a-char> <n-atom>|<a-char>|<a-char> <v-atom>| 

<n-char> <v-atom> 

<l-atonv>::= any string of characters except < ^> and < E > and 
< 3 >and < 3 > and<^ | N <l-atom>^ 

4.7 Symbols and the Symbol Table 

A symbol is an atom of type variable or type independent which 
appears in the symbol table, either ab initio or as a result of the 
user's commands. (Symbols in the symbol table, ab initio , are con- 
sidered to be reserved symbols and cannot be removed or modified.) 

The symbol table is a segment of the EDITOR which stores the type, 
value, and character representation of all symbols used by the EDITOR 
in the translation of the control language. 
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The value of a symbol depends upon the type of the symbol and may 
be either a subroutine call to perform an action upon the user's file, 
or a subroutine call to perform an action upon the symbol table itself, 
or a number used during the execution of an EDITOR action, or a sub¬ 
routine call to compute a number, or a pointer to a file location. 

4.8 Symbol Types, Values, and Definitions 
4.8.1 Symbol Types 

The EDITOR recognizes eight basic types of symbolsi 


1) 

operator; 

2) 

binary connector; 

3) 

actor; 

4) 

constant; 

5) 

argument separator; 

6) 

command separator; 

7) 

file name; and 

8) 

undefined. 

4.8.2 Op 

erators 


A symbol of type operator is a request for a specific 
action by the EDITOR. A complete list of operators will be found in 
Section VI of this report. 

4.8.3 Binary Connector 

The characters and are symbols of type binary 

connector and have the normal arithmetic meaning. 
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4.8.4 Acto r 


An actor is a symbol which has a computed numeric value 
which is some line number (see Section 3.1) of the open file, and is 
computed each time the actor appears. Actors have a value only when 
there is an open file. At other times, actors are treated as undefined 
symbols. 

The EDITOR recognizes the following actors with their 


associated meanings: 


1 In 

the value is the line number of the last line 
in the open file. 

cl n 

the value is the line number of the current line 
in the open file (cln< lln + l), and represents 
the contents of a register pointing to some line 
in the open file. 

flag(k) 

locates a given flagged line, and the value is 
equal to the line number of the flagged line (k 
must be either a symbol of type constant, see 
below, or a number 0 £ k £ 31). See Section 6.23 
for a description and example of a flagged line. 

config (’literal 1 ) 

locates a line number by a character-by-character 
search of the open file, seeking the first appear¬ 
ance of the literal argument. The search begins 
with the cln and wraps around from the last line 
to the first, stopping the search at the cln. 

The value of the config actor is the line number 
of the first line encountered which contains the 
character string literal. Note that the paren¬ 
theses and quote marks are not part of the literal 
If no value can be found, an appropriate error 
message is typed out. 
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4.8.5 Constant 


A constant is a symbol which has a numeric value. The 
value of a constant may be set by the user with the appropriate command. 
The following constants have been defined, ab initio : 


Symbol 

Numeric 

operator 

0 

binaryconnector 

1 

actor 

2 

constant 

3 

operandsep 

4 

commandsep 

5 

filename 

6 

undefined 

7 

( 

20 

) 

19 


These constants may be used as arguments for those 
commands requiring constants as arguments, and are used internally 
by the EDITOR. 

4.8.6 Argument Separator 

The character M , n (comma) is defined as a symbol of type 
argument separator , and must appear between arguments in those 
commands which take more than one argument. 
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4.8.7 Command Separator 


The character 11 (semi-colon) is defined as a symbol of 
type command separator , and must be the last character in the argument 
string of a command, including the null argument string. 

4.8.8 File Name 

A file name is a symbol which must be an atom of type 
variable and which is used to reference the user's file. File names 
must be unique. A symbol may be defined as a file name through the 
use of certain commands in the command repertoire. 

4.8.9 Undefined Symbols 

There are two types of undefined symbols. The EDITOR does 
not distinguish between them. 

1) A symbol which does not appear in the symbol table 
is undefined. 

2) A symbol which appears in the symbol table as type 
undefined is also an undefined symbol. 

Undefined symbols will appear, either directly or indirectly, 
as a result of the user's commands, and may be listed and garbage- 
collected out of the symbol table. 
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4.9 Syntactical Chart 


Meta-linguistically, the preceding definitions for symbols are 
restated as follows: 

<symbol character string>::= <v-atom>|<i-aton£> 

<operator>::= <symbol character string> defined as type operator 
<binary connector>: := + |-| <symbol character string> defined 
as type binary connector 

<constant>::= operator|binaryconnector|actor|constant|operandsep 
commandsep|filename|undefined|(|)|<symbol character 
string> defined as type constant 
<actor>: : = lln| cln| flag(<constant>)|flag(<n-char>) | f lag(<n-char> 
<n-char>)|config(<l-atom>) |<symbol character string> 
defined as type actor 

<argsep>::= ,|<symbol character string> defined as type argument 
separator 

<commandsep>::= ;|<symbol character string> defined as type 
command separator 

<file name>::= <v-atorrv> defined as type file name 
<defined symbol>::= <operator>|<binary connector>|<actor>| 
<constant>|<argsep>|<commandsep>|<file name> 

<undefined symbol>::= <symbol character string> not in the 
symbol table |<symbol character string> in the 
symbol table defined as type undefined 
<symbol>::= <defined symbol>|<undefined symbol> 
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SECTION V 


COMMAND STRUCTURE 

5.1 Definitions of Command 

A command is a user request for a specific action to be performed 
by the EDITOR. The acceptable formats are: 

1) operator; 

2) operator argument; and 

3) operator argumentl, argument2,..., argumentn; 

The "; n (semi-colon) is necessary. It is a signal to the EDITOR 
to begin execution of a command. The n , M (comma) must be used to 
separate arguments. 

5.2 Arguments 

An argument is an atom or group of atoms used as a control param¬ 
eter by EDITOR commands. 

3.3 Argument Types 

5.3.1 Exp ressions 

An expression element is a numeric atom, a constant, or an 
evaluable actor, two or more of which may be concatenated by binary 
connectors to form expressions . A binary connector may begin, but 
never end, an expression. 

5.3.2 Examples of Expressions 

-24 + a + b is an expression 
- 24 + a + b - is not an expression 
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5.3.3 File Names 


The characteristics of file names have been discussed in 
Section 4.8.8. 

5.3.4 New 

New arguments are symbols of type undefined (see Section 

4.8.9). 

5.3.5 Symbols 

An argument of type symbol is any symbol which appears in 
the symbol table and is not of the type undefined. 

5.3.6 Litera1s 

A litera1 argument is a literal atom (see Section 4.5.4). 

5.4 Syntactical Chart 

Meta-linguistically, the preceding definitions for argument 
formation can be restated: 

<expression element>::= <n-atom>|<constant>|<actor> 

<expression>::= <expression element>|<binary connector> 

<expression>|<expression> <binary connector> <expression 
element> 

<new>::= <undefined symbol> 

<argument>::= <expression>|<file name>|<new>|<defined symbol>| 

<1-a t om> 

<argument sequence>::= <argument>|<argument sequence^ <argsep> 
<argument> 

<command>::= <operator> <commandsep>|<operator> <argument sequence^ 
<commandsep> 
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SECTION VI 


EDITOR COMMANDS 

6.1 Command Notation 

The following notation is used to describe the EDITOR 1 s command 
repertoire. Any deviation from the notation will be justified as 
being prima facie understandable. 

Expressions are abbreviated in a command description as En, where 
n is a number indicating the order in which the various expressions 
appear. 

When a command requires arguments of type file name, the arguments 
are abbreviated as NaMEn, where n is a sequence number. 

New arguments are indicated in the argument list of a command by 
the word NEW and are symbols of type undefined. 

Arguments of type symbol (defined) are indicated as SYMBOL, with 
the exception of file names. 

The use of a literal argument is indicated by the appearance of 
the word LITERALn, where n is a sequence number. 

Two broad classes of legality under which most of the commands are 
either operable or inoperable depend upon whether there is or is not 
an open file. The EDITOR will always advise the user, through 
appropriate error messages, if a command is not acted upon for this 
reason. 
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The following sections comprise a complete list of all user 
commands to the EDITOR. 

6.2 1istdirectory; 

(list the directory) 

1) Arguments 

No arguments are necessary. 

2) Actions 

All file names of existing files are typed out. 

6.3 listallfiles; 

( list all files) 

1) Arguments 

No arguments are necessary. 

2) Actions 

a) FILE OPEN 

'listallfiles' is an illegal command when there is an 
open file. 

b) FILE CLOSED 

The complete contents of all defined files are typed 
out with their associated file names and line numbers. 


21 




6.4 listfile NAME; 


(list file) 

1) Arguments 

'NAME 1 must be a symbol of type file name. 

2) Actions 

a) FILE OPEN 

'listfile 1 is an illegal command when there is an open 
f ile. 

b) FILE CLOSED 

The file referenced by the symbol 'NAME' is typed out 
with the proper line numbers. 

6.5 1istsymbol table; 

(list the symbol table) 

1) Arguments 

No arguments are required. 

2) Actions 

Every symbol in the symbol table and its type, as well as 
value in the case of constants, is typed out. 
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6.6 listsymbols TYPE; 

(list symbols) 

1) Arguments 

As shown in the list below, 'TYPE' must be either an 
expression whose value is in the range from 0 through 7, or a pre¬ 
defined constant: 


Constant 

operator 

binaryconnector 

actor 

constant 

operandsep 

commandsep 

filename 

undefined 


Numeric Value 
0 
1 
2 

3 

4 

5 

6 
7 


2) Actions 

All symbols of the type specified by ’TYPE* are typed out. 
Constants have their values typed out as well. 

3) Example 

The commands ’listsymbols 2;’ and ’listsymbols actor;' are 
identical commands to the EDITOR, and will cause all symbols of type 
actor to be typed out. 
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6.7 purgesymbo1 table; 


(purge the symbol table) 

1) Arguments 

No arguments are required. 

2) Actions 

a) FILE OPEN 

The 1 purgesymboltable 1 command is illegal when there is 
an open file. 

b) FILE CLOSED 

All undefined symbols are removed from the symbol table. 
The EDITOR will type out an appropriate warning message whenever the 
symbol table is full and an attempt is made to add another symbol. 

6.8 openfile NAME; 

(open file) 

1) Arguments 

'NAME' must be a symbol of type file name. 

2) Actions 

a) FILE OPEN 

The currently open file is closed, proceed to b). 

b) FILE CLOSED 

The file referenced by the symbol 'NAME' is placed in 
the open (read and write) state. 


24 




6.9 closetile; 


(close file) 

1) Arguments 

No arguments.are required. 

2) Actions 

a) FILE OPEN 

The currently open file is closed (placed in read only 
status). 

b) FILE CLOSED 

The 'closefile 1 command is ignored. 

6.10 typecln; 

(type current line number) 

1) Arguments 

No arguments are required. 

2) Actions 

a) FILE OPEN 

The contents of the current line number register are 
typed out as shown below: 

.. the current line number is n 

b) FILE CLOSED 

'typecln* is an illegal command when there is no open 
file. 
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6.11 setcln El; 


(set current line number) 

1) Arguments 

1 El 1 must be an evaluable expression. 

2) Actions 

a) FILE OPEN 

The value of 'El' replaces the contents of the current 
line number register. 

b) FILE CLOSED 

'setcln' is an illegal command when there is no open 
file. 


26 




6.12 dcon NEW , El; 


(define constant) 

1) Arguments 

a) 'NEW' must be a symbol of type constant (which is not a 
reserved symbol) or a symbol of type undefined. 

b) 'El 1 must be an evaluable expression. 

2) Actions 

a) FILE OPEN 

If undefined, the symbol 'NEW 1 is added to the symbol 
table as a symbol of type constant, whose value is equal 
to the value of 'El 1 . If 'NEW' is already defined as a 
symbol of type constant, the value of 'El' replaces the 
current value of the constant. 

b) FILE CLOSED 
Identical to section a). 

3) Example 
dcon test,2; 

dcon test, test+test; 
setcln test; 
typecln; 

.. the current line number is 4, 
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6.13 typelln; 


(type last line number) 

1) Arguments 

No arguments are required. 

2) Actions 

a) FILE OPEN 

The line number of the highest numbered line in the 
open file is typed out in the following form: 

.. the last line number is n 

b) FILE CLOSED 

'typelln 1 is an illegal command when there is no open 
file. 

6.14 setudf SYMBOL ; 

(set undefined) 

1) Arguments 

'SYMBOL' must not be a reserved symbol. 

2) Actions 

'SYMBOL' is defined or redefined as a symbol of type 
undefined. 

CAUTION - through this command, file names can be declared to be 
of type undefined, and access to the file can thus be 
lost. 
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6.15 dsynon NEW, SYMBOL; 


(define synonym) 

1) Arguments 

a) 'NEW 1 must not be a reserved symbol. 

There are no restrictions as to the type of 'NEW 1 . 

b) ’SYMBOL 1 must not be a file name. 

2) Actions 

The symbol ’NEW 1 is defined to have the same meaning (type 
and value) as ’SYMBOL 1 . 

3) Example 

dsynon num, typecln; 
dsynon D, dsynon; 

D* • • 

u j > > 

num* 

.. the current line number is 24 * 


29 



6.16 rename OLDNAME, NEWNAME; 


(rename file) 

1) Arguments 

a) 'OLDNAME 1 must be a file name. 

b) 'NEWNAME 1 must be a symbol of type undefined. 

2) Actions 

a) FILE OPEN 

The name of the file 'OLDNAME' is changed to 'NEWNAME'. 
The symbol 'OLDNAME' is redefined to be a symbol of 
type undefined. If 'OLDNAME' is the name of the open 
file, the name of the open file is changed as above. 

b) FILE CLOSED 
Identical to a) above. 
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6.17 destroy NAME; 

(destroy file) 

1) Arguments 

'NAME' must be a symbol of type file name. 

2) Actions 

The access to the file which is referenced by the file name 
'NAME' is destroyed. The symbol 'NAME' is redefined to be of type 
undefined. 

6.18 purgefiles; 

(purge files) 

1) Arguments 

No arguments are required. 

2) Actions 

a) FILE OPEN 

The currently open file is closed, proceed to b). 

b) FILE CLOSED 

All lines not associated with a file name are removed 
from the file structure. Lines not associated with a 
file name are caused by destroyed files and the 
rewriting of altered files. 

The EDITOR will type out an appropriate warning message whenever 
the space allotted for the file structure is nearly filled. 
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6.19 type El ; or type K1.E2 ; 

(type lines) 

1) Arguments 

a) ’El* and 1 E2 1 must be less than or equal to the last 
line number. 

b) 1 E2 1 must be equal to or greater than 'El 1 . 

2) Actions 

a) FILE OPEN 

The lines in the open file whose numbers are in the 
range from f E1 1 through 1 E2 1 are typed out with their 
associated line numbers. If 'El* is the only argument, 
then that single line is typed out. 

b) FILE CLOSED 

'type* is an illegal command when there is no open file. 
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6.20 replace El, LITERALl; 

(replace lines) 
or 

replace El, LITERALl, LITERAL2,..., LITERALn; 

or 

replace El, LITERALl, 

LITERAL2, 


LITERALn; 


1) Arguments 


a) 'El' must be equal to or less than the last line number 

+ 1 . 


b) 'LITERALl', 1 LITERAL2'LITERALn' must be atoms of 
type literal (see Section 4.5.4). 


NOTE : the argument sequence of literals may be 

across the page, or typed underneath each other 
mode. This flexibility in formatting is due to 
the EDITOR traps all carriage returns, and also 
for the user as the last character in a literal 
processed as a line image (see Section 4.2). No 
contain a carriage return. 


typed 
in linear 
the fact that 
inserts them 
that is to be 
literal may 


This flexibility of formatting and the rules in the cited 

sections as to literal atom formation apply to all commands 

using literals as arguments. 

2) Actions 


a) FILE OPEN 

The value of 'El' replaces the contents of the current 
line number register. 'LITERALl' is converted into a 
line which replaces the line whose line number is equal 
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to the contents of the current line number register. The 
contents of the current line number register are then 
incremented by 1, and the above process is repeated with 
the next literal, until a symbol of type commandsep is 
detected (in this case, it is the The EDITOR then 

proceeds to the next command. 

b) FILE CLOSED 

'replace* is an illegal command when there is no open 
file. 

c) Example 

type 10,13; 

10 file line 10 

11 file line 11 

12 file line 12 

13 file line 13 

replace 11, 'replace line 1', 

'rep lace line 2’; 

type 10,13; 

10 file line 10 

11 replace line 1 

12 replace line 2 

13 file line 13 
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6.21 create NEW; 


(create file) 

1) Arguments 

'NEW 1 must be a symbol of type undefined. 

2) Actions 

a) FILE OPEN 

The open file is closed, and b) is executed. 

b) FILE CLOSED 

The symbol 'NEW 1 is defined to be a symbol of type file 
name, and space is allocated for a new file with that name. 
WARNING - the next command must be 
replace 0, LITERAL and so forth 

(see Section 6.20) in order to put something into the new file, 
starting at line zero. Failure to observe this rule will cause the 
EDITOR to write 'EMPTY FILE' as line zero. The new file is left in 
the open state at the conclusion of the 'create' command. 
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6.22 wipelastline; 


(wipe out the last line) 

1) Arguments 

No arguments are required. 

2) Actions 

a) FILE OPEN 

The highest numbered line of the open file is 

b) FILE CLOSED 

The 'wipelastline 1 command is ignored. 


destroyed. 
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6.23 merge NEW,NAME1,Ell,El 2, 


NAME2,E21,E22.NaMEn x Enl a En2; 

(merge lines) 

1) Arguments 

a) 'NEW' must be a symbol of type undefined. 

b) All 'NAMEi' must be the names of defined files. A given 
'NAMEi' may appear any number of times in the argument 
sequence. 

c) The expressions 1 Ei1 1 and 1 Ei2 1 must define blocks of 
lines contained in the file named 'NAMEi*. 

Note that 1 Ei1 1 and 1 Ei2 1 may not contain actors, as 
there is no open file during the merge operation. 

Note also that the command format permits the same 
flexibility as the 'replace' command (see Section 6.20). 

2) Actions 

a) FILE OPEN 

The open file is closed, proceed to b). 

b) FILE CLOSED 

The blocks of lines defined by 'Eil' and Ei2' are copied 
from the file 'NAMEi' into the newly defined file 'NEW', 
in order of their appearance in the argument sequence. 

At the end of the 'merge', the file 'NEW' is in the 
open state. 
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6.24 swap El,E2,E3; 


(swap lines) 

1) Arguments 

a) 1 K2 1 must be equal to or greater than 'El'. 

b) The block defined by 'E3 1 , ( 1 E3 1 + 1 E2 1 - 'El') as well 
as the block defined by 'El 1 , , E2 I , must be within the 
line number range of the open file. The two blocks may 
net share any line numbers. 

2) Actions 

a) FILE OPEN 

The lines in the block defined by 'El 1 , 1 E2 1 are exchanged 

with the lines in the block defined by 'E3 1 , ('E3 1 + 'E2 1 
- 'El 1 ). 

b) FILE CLOSED 

’swap 1 is an illegal command when there is no open file. 

3) Example 

(See section 6.25.) 
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6.25 setflag K,E1; 

(set flag) 

1) Arguments 

a) 1 K 1 must be a symbol of type constant or an atom of 
type numeric. 

'K 1 is taken modulo 32. 

b) 1 El 1 must be an evaluable expression. 

2) Actions 

a) FILE OPEN 

The flag whose flag number is 1 K 1 is bound to, and 
identified with, the 1ine whose line number is 'El 1 , 
regardless of previous definitions. 

b) FILE CLOSED 

'setflag 1 is not a legal command when there is no open 
file. 

3) Example 

a) Sample Open File 
00000 dac alpha,6 
1 last line 
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b) User Command Sequence 



setflag 1,1; 


type 

flag( 1) ; 

1 

last 

1 ine 


swap 

0,0,1; 


type 

1In-1,1In 

00000 

last 

line 

1 

dac alpha,6 


type 

flag( 1) ; 

00000 

last 

line 
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6.26 typeflags; 


(type out flags) 

1) Arguments 

No arguments are required. 

2) Actions 

a) FILE OPEN 

A table of all 32 flag numbers is typed out with the 
current state of each flag. If a flag is set and the 
associated line exists, then the line and its current 
line number are also typed out. 

b) FILE CLOSED 

‘typeflags' is an illegal command when there is no open 
file. 
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6.27 delete El; or delete E1,E2; 


(delete lines) 

1) Arguments 

a) 1 E2 1 must be equal to or greater than 'El 1 . 

b) 'El 1 and ’E2 1 must both be equal to or less than the 
highest line number. 

2) Actions 

a) FILE OPEN 

The block of lines specified by 'El 1 and 'E2 1 are 
removed from the open file. The line numbers of the 
lines from ('E2' +1) through the last line number are 
decremented by ('E2' - 'El 1 +1). If ’El' is the only 
argument, then that is the only line deleted. 

b) FILE CLOSED 

'delete 1 is an illegal command when there is no open 
file. 


42 



6.28 insert El,LITERALl,LITERAL2,... x LITERALn; 


(insert lines) 

1) Arguments 

a) 'El' must be equal to or less than the last line number. 

b) 'LITERALl', 'LITERAL2',...,'LITERALn' must be atoms of 
type literal (see sections 4.2, 4.5.4, and 6.20). 

2) Actions 

a) FILE OPEN 

The value of 'El' replaces the contents of the current 
line number register, so that insertion of the lines into 
the file occurs just before 'El'. The line numbers of the 
lines from 'El' through the last line number are increased 
by 1, and the literal 'LITERALl' is converted into a line 
whose line number equals the contents of the current line 
number register. The current line number register is then 
incremented by 1, and the above process is repeated with 
the next literal, until a symbol of type commandsep is 
detected (in this case, it is the The EDITOR then 

processes the next command. 

b) FILE CLOSED 

'insert' is an illegal command when there is no open 
file. 
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3) Example 

type 10,12; 

10 file line 10 

11 file line 11 

12 file line 12 

insert 11, 'insert line l 1 , 
'insert line 2 1 ; 

type 10,1^; 

10 file line 10 

11 insert line 1 

12 insert line 2 


13 

file 

1 ine 

11 

14 

file 

line 

12 
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6.29 dupinsert El,E2,E3; 


(duplicate and insert) 

1) Arguments 

a) Definitions 

1 - 'El' and 'E2 1 are, respectively, the lowest and 
highest line numbers of block 1. 

2 - 1 E3 1 and ( 1 E3 1 + 'E2' - 'El') are, respectively, 

the lowest and highest line numbers of block 2. 

b) Restrictions 

1 - block 1 and block 2 may not share any line numbers. 

2 - the line numbers of block 1 must be in the range 
from 0 through the highest line number. 

3 - 'E3 1 must be equal to or less than the last line 

number. 

2) Actions 

a) FILE OPEN 

The lines currently occupying block 1 are duplicated and 
written into a gap in the open file, created by incrementing 
the line numbers of the lines from 1 E3 1 through the last 
line number, by the quantity ( 1 E2 1 - 'El 1 + 1), so that 
insertion occurs just before 1 E3 1 . 

b) FILE CLOSED 

'dupinsert' is an illegal command when there is no open 
file. 
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3) Example 



type 

0,lln; 

00000 

test 

1 ine 1 

1 

test 

line 2 

2 

test 

1 ine 3 

3 

test 

1 i ne 4 

4 

test 

1 ine 5 

5 

test 

line 6 


dupinsert 0,1,4 


type 

0,lln; 

00000 

test 

1 ine 1 

1 

test 

1 ine 2 

2 

test 

line 3 

3 

test 

line 4 

4 

test 

line 1 

5 

test 

1 ine 2 

6 

test 

line 3 

7 

test 

line 6 


6.30 duprep lace El, E2,E3; 

(duplicate and replace) 

1) Arguments 

a) Definitions (same as 'dupinsert') 

1 - 'El 1 and 'E2 1 are, respectively, the lowest and 
highest line numbers of block 1. 

2 - 'E3 1 and ('E3 1 + 'E2 1 - 'El') are, respectively, the 

lowest and highest line numbers of block 2. 

b) Re s t r ictions 

1 - block 1 and block 2 may not share any line numbers. 

2 - the line numbers of block 1 must be in the range 
from 0 through the highest line number. 

3 - 'E3' must be equal to or less than the last line number+1. 

2) Actions 

a) FILE OPEN 

The lines currently occupying block 1 are duplicated and 
written into the open file, replacing the lines contained 
in block 2. 

b) FILE CLOSED 

1 dupreplace 1 is an illegal command when there is no open 
file. 
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3) Example 



type 

0,1 In; 

00000 

test 

line 1 

1 

test 

line 2 

2 

test 

line 3 

3 

test 

line 4 

4 

test 

line 5 

5 

test 

line 6 


dupr. 

eplace 0,1,4; 


type 

0,lln; 

00000 

test 

line 1 

1 

test 

line 2 

2 

test 

line 3 

3 

test 

line 4 

4 

test 

line 1 

5 

test 

line 2 
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6.31 transinsert El.E2.E3 : 


(transmit and insert) 

1) Arguments 

a) Definitions (same as 'dupinsert') 

1 - 'El 1 and 1 E2' are, respectively, the lowest and 
highest line numbers of block 1. 

2 - 1 E3 1 and ('E3 1 + 1 E2 1 - ’El 1 ) are, respectively, 

the lowest and highest line numbers of block 2. 

b) Restrictions (same as ’dupinsert') 

1 - block 1 and block 2 may not share any line numbers. 

2 - the line numbers of block 1 must be in the range 
from 0 through the highest line number. 

3 - 1 E3 1 must be equal to or less than the last line 

number. 

2) Actions 

a) FILE OPEN 

The lines currently occupying block 1 are duplicated and 
written into a gap in the open file, created by incrementing 
the line numbers of the lines from 'E3 1 through the last 
line number, by the quantity ('E2' - 'El' + 1) so that 
insertion occurs just before 'E3'. The lines in block 1 
are then destroyed and all the line numbers are adjusted 
accordingly. 
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b) FILE CLOSED 


1 transinsert 1 is an illegal command when there is no 
open file. 

3) Example 



type 

0,lln; 

00000 

test 

line 1 

1 

test 

line 2 

2 

test 

line 3 

3 

test 

line 4 

4 

test 

line 5 

5 

test 

line 6 


transinsert 


type 

0,lln; 

00000 

test 

line 3 

1 

test 

line 4 

2 

test 

line 1 

3 

test 

line 2 

4 

test 

line 5 

5 

test 

line 6 
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6.32 transreplace E1,E2,E3; 

(transmit and replace) 

1) Arguments 

a) Definitions (same as *dupinsert f ) 

1 - 'El* and 'E2 1 are, respectively, the lowest and 
highest line numbers of block 1. 

2 - *E3 1 and ('E3' + 'E2' - , E1 I ) are, respectively, 
the lowest and highest line numbers of block 2. 

b) Restrictions 

1 - block 1 and block 2 may not share any line numbers. 

2 - the line numbers of block 1 must be in the range 
from 0 through the highest line number. 

3 - 1 E3* must be equal to or less than the last line 
number-!-1. 

2) Actions 

a) FILE OPEN 

The lines currently in block 1 are duplicated and written 
into the open file replacing the lines in block 2. The 
lines in block 1 are then destroyed. 

b) FILE CLOSED 

1 transrep lace* is an illegal command when there is no 
open file. 
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3) Example 


00000 

type 

test 

0,lln; 

line 1 

I 

test 

line 2 

2 

test 

line 3 

3 

test 

line 4 

4 

test 

line 5 

5 

test 

line 6 

00000 

transreplace 

type 0,1 In; 

test line 3 

1 

test 

line 4 

2 

test 

line 1 

3 

tes t 

line 2 
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6.33 recover; 


(recover file) 

1) Arguments 

No arguments are required. 

2) Actions 

a) FILE OPEN 

The open file is restored to the state it was in immediately 
following the most recent action that put it into the 
open state. All destroyed lines originally present are 
reinserted into the file, all added lines are removed, 
and the lines are placed in their original sequence. 

WARNING - the ‘recover 1 command must not be used if the 
open file is a newly created one, as a result of a 
‘create 1 operation, as such a file actually exists as a 
list of line pointers and will not be put into the file 
structure until it is closed. Failure to observe this 
rule will cause an empty file as described in the ‘create 1 
command. To avoid the loss of the new file, after a 
substantial number of lines have been entered, it is 
recommended that the file be closed and then re-opened. 

In this way, subsequent use of the ‘recover 1 command 
will cause no loss of the file. 

b) FILE CLOSED 

‘recover 1 is an illegal command when there is no open 
f ile . 
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6.34 space; 


(space lines) 

1) Arguments 

No arguments are required. 

2) Actions 

All printouts of any file, whether open or closed, will be 
changed from single spacing to double spacing, or double 
spacing to single spacing, depending upon what spacing mode 
was being followed, initially. 

3) Example 

type 0,lln; 

00000 first line 
1 last line 

space; 

type 0,lln; 

00000 first line 

1 last line 

space; 

type 0,lln; 

00000 first line 
1 last line 
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6.35 numbers; 


(numbers) 

1) Arguments 

No arguments are required. 

2) Actions 

All printouts of any file, whether open or closed, will be 
single spaced with line numbers deleted, if they are present, 
or vice versa. This command overrides ’space 1 (see section 
6.34) as far as spacing is concerned. 

3) Example 

type 0, lln; 

00000 lac alpha 

1 add beta 

2 dac gamma 

numbers; 

type 0,lln; 

lac alpha 
add beta 
dac gamma 

numbers; 

type 0,lln; 

00000 lac alpha 

1 add beta 

2 dac gamma 
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6.36 terminate ; 

(terminate) 

1) Arguments 

No arguments are required. 

2) Actions 

If a file is open, it is closed. The directory of file names 
is saved, thus preserving current status of the files and 
symbol table, and control is then transferred to whatever 
monitor is running the system, 

6.37 reinitialize ; 

(reinitialize system) 

1) Arguments 

No arguments are required. 

2) Actions 

The file structure and directory of file names are restored 
to the original condition they were in following the last 
'purgefiles' command. All modifications to all files since 
then are canceled. All new files are destroyed. All user 
definitions are removed from the symbol table. It is obvious 
that this command should be used with due respect and caution. 
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6.38 list 1inepointers; 


(list line pointers) 

1) Arguments 

No arguments are required. 

2) Actions 

a) FILE OPEN 

A list of all lines and their associated addresses in 
storage (not line numbers) of the open file is typed out. 
This command is not intended to be of value to the user 
but is a system debugging command. 

b) FILE CLOSED 

1 1ist1inepointers 1 is an illegal command when there is 
no open file. 

6.39 listfilestructure; 

(list the file structure) 

1) Arguments 

No arguments are required. 

2) Actions 

All lines in the file structure are listed with octal pointers 
to the first character in each line. This command is not 
normally of any interest to the user and is a system 
debugging command. 
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APPENDIX I 


THE EDITOR UNDER PEST CONTROL 

Through simple typewriter commands, PEST will allow the user to 
call either the EDITOR or PAT into core from the drum--the drum having 
been initially loaded through a PEST tape. 

The EDITOR has, as its exclusive province, certain drum fields 
for its files. 

Upon a user command to PEST for magnetic tape input of files, PEST 
will write the files onto these drum fields and hand down to the EDITOR 
a drum list , giving the starting address and length of each file, up to 
a maximum of four files. 

The very first time the EDITOR is loaded into core and activated 
by pressing the start of message key, the EDITOR will check the drum 
list, and, if correct, use it to build its directory of files. In 
either case, appropriate messages will be typed out. 

Subsequent to the initial activation, the EDITOR, upon being 
loaded and started (by pressing the start of message key), refers to 
its already existing directory and merely indicates that it is ready, 
thus preserving its current status. 

If during the interim since the last 'terminate* command (see 
Section 6.36) there has been a magnetic tape input of new files, the 
EDITOR must be alerted by the 'reinitialize* command (see Section 6.37), 
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being the first command issued. Under PEST, the 'reinitialize' command 
should be used for nothing else, since using it during a system run will 
send the EDITOR to the outdated drum list. 

It should be noted that the maximum of four files applies only to 
magnetic tape input. The number of separate files allowed, at any one 
time within the EDITOR, is a function of the symbol table and file 
structure (see Section 2.2). 

After receiving and checking the drum list from PEST, the EDITOR 
will build its directory of files and, arbitrarily, name the first 
four files, in the order of their presence, "filea", "fileb", "filec", 
"filed". (Complete renaming, merging, file creating, and destroying 
facilities for the user are present in the EDITOR.) 

When issued the user command 'terminate', the EDITOR will transfer 
control to PEST, after first preserving the current status of its files 
and symbol table. It will also write out onto a fixed drum location a 
copy of the most recently opened file, filled out with right parentheses 
(to signal the end of the file) for eventual input to PAT. 

At the end of the run, PEST will allow the user to perform a tape 
dump of the entire system, which can be reloaded for the next run, thus 
preserving the current status of programs and files. 
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APPENDIX II 


LIST OF PROGRAM RESERVED SYMBOLS 


+ 


operator 

binaryconnector 

actor 

constant 
operandsep 
commandsep 
filename 
undefined 
1 In 
c In 
flag 
config 
( 

) 

and all command names listed in Appendix III, 
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APPENDIX III 


ALPHABETIC LIST OF COMMANDS 


Command 

Section 

Page 

c losefile 

6.9 

25 

create 

6.21 

35 

dcon 

6.12 

27 

delete 

6.27 

42 

destroy 

6.17 

31 

d synon 

6.15 

29 

dupinsert 

6.29 

45 

dup rep lace 

6.30 

47 

insert 

6.28 

43 

listallfiles 

6.3 

21 

Ustallfiles 

6.2 

21 

listfile 

6.4 

22 

listfilestructure 

6.39 

57 

1istlinepointers 

6.38 

57 

listsymbols 

6.6 

23 

1istsymbol table 

6.5 

22 

merge 

6.23 

37 

numbers 

6.35 

55 

openfile 

6.8 

24 

purgefiles 

6.18 

31 

purgesymboltable 

6.7 

24 
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ALPHABETIC LIST OF COMMANDS (Cont.) 


Command 

Sect ion 

Page 

r ecover 

6.33 

53 

reinitialize 

6.37 

56 

rename 

6.16 

30 

rep lace 

6.20 

33 

se tc In 

6.11 

26 

se tflag 

6.25 

39 

setudf 

6.14 

28 

space 

6.34 

54 

swap 

6.24 

38 

terminate 

6.36 

56 

t ransinsert 

6.31 

49 

transrep lace 

6.32 

51 

type 

6.19 

32 

typec In 

6.10 

25 

typeflags 

6.26 

41 

type 1 In 

6.13 

28 

wipe last line 

6.22 

36 
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APPENDIX IV 


TABLE OF COMMANDS BY FUNCTION 


File State* 

Command 

Arguments 

Section 

Page 


File Status 
Commands 




A 

closefile 


6.9 

25 

A 

create 

NEW; 

6.21 

35 

A 

destroy 

NAME; 

6.17 

31 

A 

merge 

NEW, NAME1,E11,E12,. . . 
NAMEn,Enl,En2; 

* 

6.23 

37 

A 

openfile 

NAME; 

6.8 

24 

0 

recover 


6.33 

53 

A 

rename 

OLDNAME, NEWNAME; 

6.16 

30 


File 

Printouts 




C 

1istalIfiles 


6.3 

21 

C 

1istfile 

NAME; 

6.4 

22 

0 

type 

El ; or El,E2; 

6.19 

32 


* 0 = open file 
C = closed file 
A = any state 
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TABLE OF COMMANDS BY FUNCTION (Cont.) 


File State* 

Command 

Argument s 


Section 

Page 


Open File 
Manipulation 





0 

delete 

El; or El,E2; 


6.27 

42 

0 

dupinsert 

E1,E2,E3; 


6.29 

45 

0 

dup rep lace 

E1.E2.E3; 


6.30 

47 

0 

insert 

El,LITERAL1,.. 

.,LITERALn; 

6.28 

43 

0 

rep lace 

El,LITERALS . . 

.,LITERALn; 

6.20 

33 

0 

swap 

EI,E2,E3; 


6.24 

38 

0 

transinsert 

E1,E2,E3; 


6.31 

49 

0 

transrep lace 

E1,E2,E3; 


6.32 

51 

A 

wipe last 1ine 



6.22 

36 


Symbol 

Definition 





A 

dcon 

NEW,El; 


6.12 

27 

A 

dsynon 

NEW,SYMBOL; 


6.15 

29 

A 

setudf 

SYMBOL; 


6.14 

28 


System 

Information 





A 

1 istdirectory 



6.2 

21 

A 

1istfilestructure 


6.39 

57 


* 0 = open file 
C = closed file 
A = any state 
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TABLE OF COMMANDS BY FUNCTION (Cont.) 


File State* 

Command Arguments 

Section 

Page 


System 

Information 



0 

list 1inepointers 

6.38 

57 

A 

listsymbols TYPE; 

6.6 

23 

A 

1ist symboltable 

6.5 

22 

0 

setcIn El; 

6.11 

26 

0 

setflag K,E1; 

6.25 

39 

0 

t yp e c 1 n 

6.10 

25 

0 

typeflags 

6.26 

41 

0 

type 1In 

6.13 

28 


F o rma t 

Command s 



A 

numbers 

6.35 

55 

A 

space 

6.34 

54 


Garbage 

Collection 



A 

purgefiles 

6.18 

31 

C 

purgesymboltable 

6.7 

24 


System Status 



a 

reinitialize 

6.37 

56 

A 

terminate 

6.36 

56 


* 0 = open file 
C = closed file 
A = any state 
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APPENDIX V 


BACKUS NORMAL FORM 

Backus normal form (B.N.F.) is a type of notation developed to 
describe unambiguously the syntax or rules of formation of a 
programming language. It is, essentially, a language for describing 
languages, or a meta-language. The most important aspect of Backus 
normal form is its recursive definition ability, which allows 
description of all the possible and syntactically correct character 
strings of the particular language being described. 

The symbology of the notation consists of 
" < ", " > ", and "| M . 

"| " is the "exclusive or" operator and is used on the right-hand 
side of a B.N.F. statement to distinguish between the different 
possible character strings. 

" < 11 and 11 > 11 are used as the left and right delimiters, 
respectively, of a B.N.F. symbol. 

" is the B.N.F. "equals" or assignment operator, which sets 
the left-hand side of a B.N.F. statement equal to the right-hand side, 
with the provision that a B.N.F. symbol may appear on either side, 
thus providing recursive capability. 
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The B.N.F. statement 


<digit>::= 01 11 2| 31 41 51 61 71 81 9 

means that a digit has been defined as 0 or 1 or 2 or 3 or 4 or 5 or 6 
or 7 or 8 or 9 . 

The B.N.F. statement 

<number>::= <digit>| <number> <digit> 
means that a number has been defined as a digit or a number followed 
by a digit. The symbols <number> <digit> expand to <digit> <digit> or 
<number> <digit> <digit>, since a number has been recursively defined 
as either a digit or a number followed by a digit. Thus, with a 
rather simple B.N.F. statement, the definition of a number has been 
expressed as any possible string of digits of any possible length, as 
<number> <digit> may be recursively substituted for <number> as many 
times as necessary. 
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APPENDIX VI 


FURTHER ILLUSTRATIVE EXAMPLES 

1. Repetitive use of the following command 

delete config( 1 xyz 1 ); 

will delete all lines where "xyz" occurs, from the open file, and the 
EDITOR will type out a message indicating that there are no further 
occurrences. 

2. The following example is included with no further comment: 

create fun; 

replace 0, 'ZERO', 

'ONE', 

'TWO', 

'THREE' , 

'FOUR'; 

type 0, lln; 

00000 ZERO 

1 ONE 

2 TWO 

3 THREE 

4 FOUR 
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setcln 0; transinsert lln,lln,cln; 
setcln cln+1; transinsert lln,lln,cln; 
setcln cln+1; transinsert lln,lln,cln; 
setcln cln+1; transinsert lln,lln,cln; 

type 0,1In ; 

00000 FOUR 

1 THREE 

2 TWO 

3 ONE 

4 ZERO 
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